@aws-sdk/types

What is @aws-sdk/types?

The @aws-sdk/types package provides TypeScript definitions for the AWS SDK for JavaScript v3. These types define the shapes of AWS service clients, commands, input and output parameters, and other utility types that are used across the AWS SDK. This package is essential for TypeScript developers using the AWS SDK as it enables type checking and IntelliSense support in IDEs.

What are @aws-sdk/types's main functionalities?

Service Client Interface

Defines the configuration interface for an AWS service client, such as the S3 client. It extends from a base client configuration and includes service-specific options.

{"interface S3ClientConfig extends SmithyClientConfig {endpoint?: HttpEndpoint, forcePathStyle?: boolean, useAccelerateEndpoint?: boolean, ...}}

Command Interface

Represents a command interface that defines input and output types for a specific operation. It also includes methods for resolving middleware in the command's execution stack.

{"interface Command<InputType extends object, OutputType extends object, ResolvedClientConfiguration, ClientInput extends InputType = InputType, ClientOutput extends OutputType = OutputType> {resolveMiddleware(stack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: ResolvedClientConfiguration): Handler<ClientInput, ClientOutput>; ...}}

Middleware Stack

Defines the middleware stack interface used in the AWS SDK. Middleware are functions that can modify requests and responses or handle specific tasks like logging or error handling.

{"interface MiddlewareStack<Input extends object, Output extends object> {add(middleware: MiddlewareType<Input, Output>, options?: MiddlewareStackOptions): void; addRelativeTo(middleware: MiddlewareType<Input, Output>, options: RelativeMiddlewareOptions): void; ...}}

Other packages similar to @aws-sdk/types

@google-cloud/common

Provides types and utility functions for Google Cloud client libraries for Node.js. Similar to @aws-sdk/types, it offers TypeScript definitions but for Google Cloud services.

azure-sdk-for-js

The Azure SDK for JavaScript provides TypeScript type definitions for Azure services. It is analogous to @aws-sdk/types but tailored for Microsoft Azure's cloud services.

@types/node

This package contains type definitions for Node.js. While not specific to a cloud provider, it serves a similar purpose by providing TypeScript types for Node.js core modules, much like @aws-sdk/types does for AWS SDK.

README

@aws-sdk/types

Changelog

3.734.0 (2025-01-23)

Features

• client-ec2: Added "future" allocation type for future dated capacity reservation (752ea12)
• credential-providers: pass caller client options to fromTemporaryCredentials inner STSClient (#6838) (0d0b14e)